home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat2 / standard / getpid.z / getpid
Encoding:
Text File  |  2002-10-03  |  5.8 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ggggeeeettttppppiiiidddd((((2222))))                                                            ggggeeeettttppppiiiidddd((((2222))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _gggg_eeee_tttt_pppp_iiii_dddd, _gggg_eeee_tttt_pppp_gggg_rrrr_pppp, _gggg_eeee_tttt_pppp_pppp_iiii_dddd, _gggg_eeee_tttt_pppp_gggg_iiii_dddd, _BBBB_SSSS_DDDD_gggg_eeee_tttt_pppp_gggg_rrrr_pppp - get process, process
  10.      group, and parent process IDs
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_tttt_yyyy_pppp_eeee_ssss_...._hhhh_>>>>
  14.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_uuuu_nnnn_iiii_ssss_tttt_dddd_...._hhhh_>>>>
  15.  
  16.      _pppp_iiii_dddd______tttt _gggg_eeee_tttt_pppp_iiii_dddd_((((_vvvv_oooo_iiii_dddd_))))_;;;;
  17.  
  18.      _pppp_iiii_dddd______tttt _gggg_eeee_tttt_pppp_gggg_rrrr_pppp_((((_vvvv_oooo_iiii_dddd_))))_;;;;
  19.  
  20.      _pppp_iiii_dddd______tttt _gggg_eeee_tttt_pppp_pppp_iiii_dddd_((((_vvvv_oooo_iiii_dddd_))))_;;;;
  21.  
  22.      _pppp_iiii_dddd______tttt _gggg_eeee_tttt_pppp_gggg_iiii_dddd_((((_pppp_iiii_dddd______tttt _pppp_iiii_dddd_))))_;;;;
  23.  
  24.      _pppp_iiii_dddd______tttt _BBBB_SSSS_DDDD_gggg_eeee_tttt_pppp_gggg_rrrr_pppp_((((_pppp_iiii_dddd______tttt _pppp_iiii_dddd_))))_;;;;
  25.  
  26. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  27.      _gggg_eeee_tttt_pppp_iiii_dddd returns the process ID of the calling process.
  28.  
  29.      _gggg_eeee_tttt_pppp_gggg_rrrr_pppp returns the process group ID of the calling process.  The
  30.      _BBBB_SSSS_DDDD_gggg_eeee_tttt_pppp_gggg_rrrr_pppp form is provided for Berkeley compatibility.  If the pid_t is
  31.      0, it is the same as the _gggg_eeee_tttt_pppp_gggg_rrrr_pppp form, otherwise it returns the process
  32.      group for the argument, if the process exists.
  33.  
  34.      _gggg_eeee_tttt_pppp_pppp_iiii_dddd returns the parent process ID of the calling process.
  35.  
  36.      _gggg_eeee_tttt_pppp_gggg_iiii_dddd returns the process group ID of the process whose process ID is
  37.      equal to _p_i_d, or the process group ID of the calling process, if _p_i_d is
  38.      equal to zero.
  39.  
  40.      _gggg_eeee_tttt_pppp_gggg_iiii_dddd will fail if one or more of the following is true:
  41.  
  42.      _EEEE_PPPP_EEEE_RRRR_MMMM          If the process whose process ID is equal to _p_i_d is not in
  43.                     the same session as the calling process, the
  44.                     implementation does not allow access to the process group
  45.                     ID of that process from the calling process.  Under IRIX,
  46.                     access to the group ID of that process is always allowed
  47.                     to the calling process.
  48.  
  49.      _EEEE_AAAA_CCCC_CCCC_EEEE_SSSS         In the Trusted IRIX environment, the MAC label of the
  50.                     current process does not dominate and is not equal to the
  51.                     MAC label of the process _p_i_d , and the current process
  52.                     does not have the CCCCAAAAPPPP____MMMMAAAACCCC____RRRREEEEAAAADDDD capability.
  53.  
  54.      _EEEE_IIII_NNNN_VVVV_AAAA_LLLL         The _p_i_d is out of range or is an invalid argument.
  55.  
  56.      _EEEE_SSSS_RRRR_CCCC_HHHH          There is no process with a process ID equal to _p_i_d.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ggggeeeettttppppiiiidddd((((2222))))                                                            ggggeeeettttppppiiiidddd((((2222))))
  71.  
  72.  
  73.  
  74. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  75.      _eeee_xxxx_eeee_cccc(2), _ffff_oooo_rrrr_kkkk(2), _gggg_eeee_tttt_pppp_iiii_dddd(2), _gggg_eeee_tttt_ssss_iiii_dddd(2), _iiii_nnnn_tttt_rrrr_oooo(2), _ssss_eeee_tttt_pppp_gggg_iiii_dddd(2), _ssss_eeee_tttt_ssss_iiii_dddd(2)
  76.      _ssss_eeee_tttt_pppp_gggg_rrrr_pppp(2), _ssss_iiii_gggg_nnnn_aaaa_llll(2), _cccc_aaaa_pppp_aaaa_bbbb_iiii_llll_iiii_tttt_iiii_eeee_ssss(4), _dddd_oooo_mmmm_iiii_nnnn_aaaa_nnnn_cccc_eeee(5).
  77.  
  78. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  79.      Upon successful completion, _gggg_eeee_tttt_pppp_gggg_iiii_dddd returns a process group ID.
  80.      Otherwise, a value of (_pppp_iiii_dddd______tttt) -1 is returned and _eeee_rrrr_rrrr_nnnn_oooo is set to indicate
  81.      the error.
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.